home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games: Greatest Hits 1996 / Amiga Games: Greatest Hits 1996.iso / userbox / publicdomain / amifig2.0 / fig.man < prev    next >
Text File  |  1996-05-05  |  15KB  |  379 lines

  1.  
  2.  
  3.  
  4. FIG(1)                   USER COMMANDS                     FIG(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      fig - Facility for Interactive Generation of figures
  10.  
  11. SYNOPSIS
  12.      fig [ -r ] [ file ]
  13.  
  14. DESCRIPTION
  15.      Fig is a menu-driven tool that allows the user to  draw  and
  16.      manipulate  objects  interactively  on  the  screen of a Sun
  17.      Workstation. It  can  only  be  run  within  the  SunWindows
  18.      environment  and requires a three-button mouse.  File speci-
  19.      fies the name of a file to be  edited.  The  description  of
  20.      objects in the file will be read at the start of fig.
  21.  
  22.      The output from fig can be printed by first using  f2p  (fig
  23.      to  pic(1)  translator,  also  known  by  its  previous name
  24.      ftop(1L)) to translate it into pic(1) language.  The  pic(1)
  25.      file  can  be  saved and edited like ordinary text file.  To
  26.      print the file one should issue the command:
  27.      pic file | troff
  28.      adding any required options to the invocation  of  troff(1).
  29.      The  file may be used in conjunction with any other troff(1)
  30.      preprocessors.
  31.  
  32.      Another way to produce a hrad copy is to use f2ps  (the  fig
  33.      to  postscript translator) to produce a postscript file from
  34.      fig file.  The postscript file can be  sent  directly  to  a
  35.      postscript printer via lpr(1).
  36.  
  37. OPTIONS
  38.      -r   Change the position of the panel window to the right of
  39.           the canvas window (default: left).
  40.  
  41. GRAPHICAL OBJECTS
  42.      The objects in fig are divided into  primitive  objects  and
  43.      compound  object.  The  primitive  objects are: ARC, CIRCLE,
  44.      CLOSED SPLINE, ELLIPSE, POLYLINE, POLYGON, SPLINE, and TEXT.
  45.      A  primitive  can  be  moved,  rotated,  flipped,  copied or
  46.      erased.  A compound object is composed of primitive objects.
  47.      The  primitive objects that constitute a compound can not be
  48.      individually modified, but they can  be  manipulated  as  an
  49.      entity; a compound can be moved, rotated, flipped, copied or
  50.      erased.  An extra function that can be applied to a compound
  51.      object  is  scaling,  which  is  not available for primitive
  52.      objects.
  53.  
  54. DISPLAY WINDOWS
  55.      Three windows comprise the display area of  fig:  the  panel
  56.      window  the  message window, and the canvas window. The mes-
  57.      sage window always appears below the others; it is the  area
  58.      in  which  messages are sent and received. from the The menu
  59.      window can be placed to the left or right of the the  canvas
  60.      window (default: left).
  61.  
  62. POP-UP MENU
  63.      The pop-up menu appears  when  the  right  mouse  button  is
  64.      pressed with the cursor positioned within the canvas window.
  65.      Positioning the cursor  over  the  desired  menu  entry  and
  66.      releasing the button selects a menu entry.
  67.  
  68.      There are a number of file accessing functions in the pop-up
  69.      menu.   Most  of  the  time  when  one of these functions is
  70.      selected, the user will be asked for a file  name.   If  the
  71.      specified  file can be located and the access permission are
  72.      granted, fig will carry out the function.  However  in  case
  73.      things go wrong, fig will abort the function and printed the
  74.      causes on the message window.
  75.  
  76.      Undo Undo the last object creation or modification.
  77.  
  78.      Redisplay
  79.           Redraw the canvas.
  80.  
  81.      Remove all
  82.           Remove  all  objects  on  the  canvas  window  (can  be
  83.           undone).
  84.  
  85.      Edit file ...
  86.           The current contents of  the  canvas  are  cleared  and
  87.           objects  are  read  from  the specified file.  The user
  88.           will be asked for a file name.  This file  will  become
  89.           the current file.
  90.  
  91.      Save Save the current contents of the canvas in the  current
  92.           file.   If  no  file  is being edited, the user will be
  93.           asked for a file name as in the "Save in ..." function.
  94.  
  95.      Read file ...
  96.           Read objects from the specified  file  and  merge  them
  97.           with  objects  already  shown on the canvas.  (The user
  98.           will be asked for a file name.)
  99.  
  100.      Save as ...
  101.           Save objects on the screen into a file specified by the
  102.           user.  (The user will be asked for a file name.)
  103.  
  104.      Status
  105.           Show the name of the current file and directory.
  106.  
  107.      Change Directory
  108.           Change the working directory.  Any file name without  a
  109.           full  path  name will employ the current working direc-
  110.           tory.
  111.  
  112.      Save & Exit
  113.           Save the objects in the current file and exit from fig.
  114.           If there is no current file, the user will be asked for
  115.           a file name.  No confirmation will be asked.
  116.  
  117.      Quit Exit from fig, discarding all objects. The user will be
  118.           asked  to confirm the action, by clicking the left but-
  119.           ton.
  120.  
  121.      Save as BITMAP ...
  122.           Create a bitmap picture of the drawings  for  use  with
  123.           other  tools  (for  example,  for use as an icon).  The
  124.           smallest rectangular area of  pixels  that  encompasses
  125.           the  figure is written to the named file (the user will
  126.           be asked for a file name) from top row  to  bottom  and
  127.           left  to  right  (in  Sun  raster  format).   Only TEXT
  128.           objects that are parts  of  compound  objects  will  be
  129.           treated  as parts of the picture; other texts are saved
  130.           as objects in fig format  following  the  bitmap  data.
  131.           The  coordinates  of  these text objects can be used to
  132.           identify locations on the bitmap.
  133.  
  134. MENU WINDOW MANIPULATION FUNCTIONS
  135.      Icons in the menu window represent object manipulation func-
  136.      tions,  modes and other drawing or modification aids.  Mani-
  137.      pulation functions are selected by  positioning  the  cursor
  138.      over  it  and  clicking the left mouse button.  The selected
  139.      icon is highlighted, and a message describing  its  function
  140.      appears in the message window.
  141.  
  142.      The left and middle buttons are used  to  creat  and  modify
  143.      objects  in  the  canvas  window.   Most  actions start with
  144.      clicking of the left button and end  with  clicking  of  the
  145.      right  button.  There is no need to hold down a button while
  146.      positioning the cursor.
  147.  
  148. MENU WINDOW COMMAND DESCRIPTIONS
  149.      Entries in the panel  window  can  be  classified  into  two
  150.      categories:  object  creation/modification/removal  commands
  151.      (only one of which may be active at any one time), and draw-
  152.      ing aids (which act as toggle switches).  There are two ways
  153.      for drawing circles, two for ellipses, two for  splines  and
  154.      two  for  closed splines.  There are two basic splines.  One
  155.      is the interpolated spline in which the spline pass thorough
  156.      the  entered points (knots).  The other is the normal spline
  157.      in which on control points are passed by the spline  (except
  158.      for the two end points in the open spline).
  159.  
  160. OBJECT CREATION/MODIFICATION/REMOVAL
  161.      Multiple commands are grouped thematically in the  following
  162.      descriptions (which is listed alphabetically).
  163.  
  164.      ADD/DELETE ARROWS
  165.           Add or delete arrow heads for POLYLINE, POLYGON, SPLINE
  166.           or  CLOSED  SPLINE  objects (points of a BOX can not be
  167.           added or deleted).
  168.  
  169.      ADD/DELETE POINTS
  170.           Add or delete points for POLYLINE, POLYGON,  SPLINE  or
  171.           CLOSED SPLINE objects (points of a BOX can not be added
  172.           or deleted).
  173.  
  174.      ARC  Create an arc.  Specify three  points  using  the  left
  175.           button.
  176.  
  177.      BOX  Create rectangular boxes.  Start with the  left  button
  178.           and terminate with the right button.
  179.  
  180.      BREAK COMPOUND
  181.           Break  a compound object to allow manipulation  of  its
  182.           component parts.  Click the left button on the bounding
  183.           box of the compound object.
  184.  
  185.      CIRCLE
  186.           Create circles by specifying their radii or  diameters.
  187.           Click  the  left  button on the canvas window, move the
  188.           cursor until the desired radius or diameter is reached,
  189.           then  click  the middle button to terminate. The circle
  190.           will be drawn after the pressing of the middle button.
  191.  
  192.      CLOSED INTERPOLATED SPLINE
  193.           Create closed or periodic  splines.   The  function  is
  194.           similar  to  POLYGON  except that a closed interpolated
  195.           spline is drawn.  The  spline  will  pass  through  the
  196.           points (knots).
  197.  
  198.      CLOSED SPLINE
  199.           Create closed or periodic spline objects.  The function
  200.           is  similar to POLYGON except that a closed spline will
  201.           be drawn instead of polygon.  The  entered  points  are
  202.           just control points; i.e., the spline will not pass any
  203.           of these points.
  204.  
  205.      COPY Copy object.  Click the left button over  part  of  the
  206.           object  to  be  copied (for CIRCLE and ELLIPSE objects,
  207.           position on their circumferences).  Drag the object  to
  208.           the desired position and click the middle button.  This
  209.           function as  well  as  the  following  three  functions
  210.           (MOVE,  MOVE  POINT,  REMOVE)  will cause point markers
  211.           (manipulation aids) to be shown on the  canvas  window.
  212.           There are no markers for CIRCLE or ELLIPSE objects.
  213.  
  214.      ELLIPSE
  215.           Create ellipses using the same  procedure  as  for  the
  216.           drawing of circles.
  217.  
  218.      GLUE Glue the primitive objects within a bounding box into a
  219.           compound object (the bounding box itself is not part of
  220.           the figure; it is a visual  aid  for  manipulating  the
  221.           compound).
  222.  
  223.      INTERPOLATED SPLINE
  224.           Create (cubic spline) spline  objects.   Enter  control
  225.           vectors  in  the same way as for creation of a POLYLINE
  226.           object.  At least three points  (two  control  vectors)
  227.           must  be  entered.   The  spline  will pass through the
  228.           entered points.
  229.  
  230.      MOVE Move objects in the same way as in COPY.
  231.  
  232.      MOVE POINT
  233.           Modify  the  position  of  points  of  POLYLINE,   BOX,
  234.           POLYGON,  ELLIPSE,  ARC  and SPLINE objects.  Click the
  235.           left button over  the  desired  point,  reposition  the
  236.           point,  and click the middle button.  Note that BOX and
  237.           POLYGON  objects  are  internally  stored  as  POLYLINE
  238.           objects,  and  therefore moving certain points may open
  239.           these objects.
  240.  
  241.      POLYGON
  242.           Same as POLYLINE except that a line  segment  is  drawn
  243.           connecting the first and last points entered.
  244.  
  245.      POLYLINE
  246.           Create polylines (line segments connecting  a  sequence
  247.           of  points).   Enter points by clicking the left button
  248.           at the desired positions on the canvas  window.   Click
  249.           the middle button to terminate.
  250.  
  251.      REMOVE
  252.           Remove (or delete) objects.
  253.  
  254.      SCALE COMPOUND
  255.           Only compound objects can be scaled.   Click  the  left
  256.           button  on  a  corner  of the bounding box, stretch the
  257.           bounding box to the desired size, and click the  middle
  258.           button.
  259.  
  260.      SPLINE
  261.           Create (quadratic spline) spline objects.   Enter  con-
  262.           trol vectors in the same way as for creation of a POLY-
  263.           LINE object.  At least three points (two  control  vec-
  264.           tors)  must  be entered.  The spline will pass only the
  265.           two end points.
  266.  
  267.      TEXT Create text strings.  Click  the  left  button  at  the
  268.           desired  position on the canvas window, then enter text
  269.           from the keyboard.  Terminate by  clicking  the  middle
  270.           button or typing the return key.
  271.  
  272.      TURN Turn POLYGON into a CLOSED INTERPOLATED SPLINE  object,
  273.           or turn POLYLINE into a INTERPOLATED SPLINE object.
  274.  
  275. DRAWING AIDS
  276.      Drawing aids act as toggle switches. More than  one  can  be
  277.      selected  at  a  time  (except for GRID and the line drawing
  278.      modes).
  279.  
  280.      AUTO FORWARD/BACKWARD ARROW
  281.           Automatically add forward/backward arrow heads to POLY-
  282.           LINE, SPLINE or ARC objects.
  283.  
  284.      FLIP Invert the object (middle button) or produce a  mirror-
  285.           image copy of an object (left button). Point to part of
  286.           the object ("the handle"), click the  appropriate  but-
  287.           ton.
  288.  
  289.      GRID Display either the quarter- or  half-inch  grids  (left
  290.           button).
  291.  
  292.      MAGNET
  293.           Round points to the nearest  1/16  of  an  inch.   This
  294.           affects every function, and is provided as an alignment
  295.           aid.
  296.  
  297.      UNRESTRICTED
  298.           Allow lines to be drawn with any slope.
  299.  
  300.      MANHATTAN
  301.           Enforce drawing of lines in the horizontal and vertical
  302.           direction  only.   Both  MANHATTAN  and MOUNTAIN can be
  303.           turned on simultaneously.  The  creations  of  POLYGON,
  304.           POLYLINE  and  SPLINE objects are affected by these two
  305.           modes.
  306.  
  307.      MOUNTAIN
  308.           Enforce drawing of only diagonal lines.  Both MANHATTAN
  309.           and MOUNTAIN can be turned on simultaneously. The crea-
  310.           tions of  POLYGON,  POLYLINE  and  SPLINE  objects  are
  311.           affected by these two modes.
  312.  
  313.      MANHATTAN MOUNTAIN
  314.           Allow lines to be drawn at any slope  allowed  when  in
  315.           MOUNTIAIN or MANHATTAN modes.
  316.  
  317.      LATEX LINE
  318.           Allow lines to be drawn only at  slopes  which  can  be
  319.           handled  by  LaTeX  picture  environment lines: slope =
  320.           x/y, where x,y are integers in the range [-6,6].
  321.  
  322.      LATEX VECTOR
  323.           Allow lines to be drawn only at  slopes  which  can  be
  324.           handled  by  LaTeX picture environment vectors: slope =
  325.           x/y, where x,y are integers in the range [-4,4].
  326.  
  327.      ROTATE
  328.           Rotate the object (middle button) or copy (left button)
  329.           +90 degrees.
  330.  
  331.      SOLID/DASHED LINE STYLE
  332.           Toggle between solid and dashed line styles.  The  dash
  333.           length is fixed at 0.05 inch.
  334.  
  335. BUGS
  336.      Text strings will appear differently on hard  copy,  because
  337.      the display fonts are fixed-width fonts while the fonts used
  338.      by pic(1) are variable-width fonts.
  339.  
  340.      A double quote in a text string should be preceded by a back
  341.      slash if the it is to be printed through pic(1).
  342.  
  343.      Objects that extend beyond the canvas window may cause image
  344.      shrinkage  in hard copy printed by pic(1), since it will try
  345.      to fit every object onto a single 8.5" x 11" page.
  346.  
  347.      Ellipses which are too narrow may cause fig to loop forever.
  348.  
  349.      Objects which are created while one of the grids is  on  may
  350.      appear  ragged. This can be corrected by selecting Redisplay
  351.      from the pop-up menu.
  352.  
  353.      The X11 cursors are not the original ones  but  chosen  from
  354.      X11's cursor font.
  355.  
  356.      Righthand panel is not supported. It should be  possible  to
  357.      do that but Ken was too lazy.
  358.  
  359. SEE ALSO
  360.      Brian W. Kernighan PIC - A Graphics Language for Typesetting
  361.      User Manual
  362.      col(1) ditroff(1), eqn(1), f2p(1), f2ps(1),  man(7),  me(7),
  363.      ms(7), pic(1), tbl(1), troff(1),
  364.  
  365. ACKNOWLEDGEMENT
  366.      Many thanks goes to Professor Donald E. Fussell who inspired
  367.      the creation of this tool.
  368.  
  369. AUTHOR
  370.      Supoj Sutanthavibul
  371.      University of Texas at Austin
  372.      (supoj@sally.UTEXAS.EDU)
  373.  
  374.      Manual page modified by R. P. C.  Rodgers,  UCSF  School  of
  375.      Pharmacy, San Francisco, CA 94118
  376.  
  377.      Frank Schmuck of Cornell contributed the LaTeX line  drawing
  378.      modes.
  379.